Skip to content

docs: explain addon version differences - #8868

Merged
gustavodiaz7722 merged 1 commit into
eksctl-io:mainfrom
atharvaHJoshi:docs/7864-addon-version-documentation
Sep 18, 2026
Merged

gustavodiaz7722 merged 1 commit into
eksctl-io:mainfrom
atharvaHJoshi:docs/7864-addon-version-documentation

Conversation

@atharvaHJoshi

Copy link
Copy Markdown
Contributor

Fixes #7864

What this PR does

Users compared the version applied by eksctl utils update-aws-node /
update-kube-proxy / update-coredns against the list from
eksctl utils describe-addon-versions and saw mismatches. This is by design, but the
docs did not explain it.

Changes

Adds a "What 'latest' means for each command" section to the default add-on update
guide that clarifies:

  • describe-addon-versions lists EKS Managed Add-on versions (their own release
    cadence and -eksbuild.x suffix).
  • update-aws-node / update-coredns apply the manifest bundled with the eksctl
    release
    ("known good" version), not the newest EKS-managed version.
  • update-kube-proxy resolves the newest version for the cluster's control-plane
    version from the EKS API.
  • How to get the newest EKS-managed version instead (install/update them as managed
    add-ons via eksctl create addon / eksctl update addon --version latest).

Signed-off-by: Atharva Joshi <josh.atharva2005@gmail.com>
@github-actions

Copy link
Copy Markdown
Contributor

Hello atharvaHJoshi 👋 Thank you for opening a Pull Request in eksctl project. The team will review the Pull Request and aim to respond within 1-10 business days. Meanwhile, please read about the Contribution and Code of Conduct guidelines here. You can find out more information about eksctl on our website

@gustavodiaz7722 gustavodiaz7722 added the kind/docs User documentation label Sep 18, 2026
@gustavodiaz7722
gustavodiaz7722 enabled auto-merge (squash) September 18, 2026 21:15
@gustavodiaz7722
gustavodiaz7722 merged commit f131ac5 into eksctl-io:main Sep 18, 2026
8 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/docs User documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug] Default addons update version is different with listed latest version.

2 participants